home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / FROMUTS / REPLAY / allofit / !ARMovie / AE7doc < prev    next >
Text File  |  1992-09-21  |  7KB  |  194 lines
  1. File format AE7: ARMovie
  2. ========================
  3.  
  4. Start of file:
  5.  
  6. String          ARMovie
  7. String          Movie name
  8. String          date and copyright details
  9. String          author and other details
  10. String          video compression format identifier     [1][0 -> no video]
  11. Decimal number  x size in pixels
  12. Decimal number  y size in pixels
  13. Decimal number  z pixel depth in bits [16]
  14. Decimal number  number of frames per second to project at
  15. String          sound compression format identifier     [0 -> no sound]
  16. Decimal number  sound replay rate in Hz (or fractions of)
  17. Decimal number  number of sound channels recorded ("reversed" if l<->r)
  18. Decimal number  sound precision ("linear" if linear, "unsigned" if unsigned)
  19. Decimal number  number of frames in a chunk
  20. Decimal number  number of chunks NC (chunks start at 0!!!!)
  21. Decimal number  "even" chunk size in bytes
  22. Decimal number  "odd" chunk size in bytes
  23. Decimal number  offset to chunk catalogue CC
  24. Decimal number  offset to "helpful" sprite
  25. Decimal number  size in bytes of the "helpful" sprite info
  26. Decimal number  offset to key frames                    [0/null -> no keys]
  27.                 other gunge as required
  28.  
  29. (all fields are ASCII text terminated by NewLine; spaces
  30. ignored, arbitary comment text after numeric field permitted)
  31.  
  32. byte CC: start of catalogue of chunks
  33.          this has NC+1 entries of the form:
  34.               file offset of chunk (maybe multiple of 1024)
  35.               size of video data
  36.               size of sound data (immediately after video data)
  37.          arranged FO,BS;OS<newline> (spaces permitted except in numbers)
  38.  
  39. The 'key frame offset' points to a set of NC (not NC+1) blocks of data
  40. containing x*y*z bits. These allow the decompressor to start at a particular
  41. chunk. Starting at the first chunk doesn't need a reference to the key frame
  42. offsets.
  43.  
  44. Example:
  45. ARMovie
  46. The Concert
  47. (c) Notts University 1991
  48. Created by Notts University, digitised by Acorn Computers
  49. 1
  50. 160 pixels
  51. 128 pixels
  52. 16 bits per pixel 
  53. 25 frames per second
  54. 1
  55. 12000 Hz samples
  56. 1 channel
  57. 8 bits per sample (exponential)
  58. 50 frames per chunk
  59. 57 chunks
  60. 204080
  61. 192992
  62. 10580256 catalogue offset
  63. 512 sprite offset
  64. 20480 sprite size
  65. 105602 key frames offset
  66.  
  67. Multiple Sound Tracks
  68. ---------------------
  69.  
  70. The single video track can have an arbitary number of sound tracks associated
  71. with it. Extra sound track data for each sound parameter follows the sound
  72. track marker "|" plus the sound track number. Different sound tracks can have
  73. completely different parameters - compression format, sample rate, number of
  74. channels, number of bits per sample. The first sound track is played by default
  75. and does not follow a |1 marker - thus the first additional sound track has
  76. parameters following a |2 marker.
  77.  
  78. Example:
  79. ARMovie
  80. The Concert
  81. (c) Notts University 1991
  82. Created by Notts University, digitised by Acorn Computers
  83. 1
  84. 160 pixels
  85. 128 pixels
  86. 16 bits per pixel 
  87. 25 frames per second
  88. 1                               |2   1                     |3  1
  89. 12000 Hz samples                |2   16000                 |3  20000
  90. 1 channel                       |2   2 channels            |3  2 channels
  91. 8 bits per sample (exponential) |2   16 bits per sample    |3  4 bits (adpcm)
  92. 50 frames per chunk
  93. 57 chunks
  94. 236080
  95. 228992
  96. 10580256 catalogue offset
  97. 512 sprite offset
  98. 20480 sprite size
  99. 105602 key frames offset
  100.  
  101. The catalogue entries are similarly marked:
  102.  
  103.               file offset of chunk (maybe multiple of 1024)
  104.               size of video data
  105.               size of sound data 1 (immediately after video data)
  106.               |2
  107.               size of sound data 2 (immediatley after sound data 1)
  108.          arranged FO,BS;OS|2 OS<newline> (spaces permitted except in numbers)
  109.  
  110. Playing sound tracks later than the first one uses more memory (the decompressor
  111. reads the chunk up to and including the sound data it needs).
  112.  
  113. 16 bit sound data is aligned to the next word.
  114.  
  115. Although it is possible to have multiple sound tracks in a file with no video,
  116. it is probably better to have multiple ARMovie files instead.
  117.  
  118. A note about the ARMovie's file name
  119. ------------------------------------
  120.  
  121. The movie replay program adds the ARMovie$Suffix to any path name given to it:
  122. it tries to open this file, then tries again with the original path name. (just
  123. like the window manager with !Sprites, !Sprites22 etc). This allows a degree of
  124. personalisation of replay invisible to all programs.
  125.  
  126. Therefore we recommend the follow standard suffix characters:
  127.  
  128. "2" a movie made at half the frame rate of its base movie
  129.     this movie can be expected to be playable on less powerful machines
  130.     (generaliseable if required!)
  131.  
  132. "S" a movie made with much smaller chunks than its base movie
  133.     this movie can be expected to be playable on small memory machines (an "S"
  134.     suffix movie may not work from a CD-ROM drive). For example if the base
  135.     movie has 2 second chunks, then an "S" suffix might only have 1 second
  136.     chunks.
  137.  
  138. "L" a movie made with much larger chunks than its base movie
  139.     this movie will not work on CD-ROM, but can be copied from CD-ROM to
  140.     a faster filing system (winchester, magneto-optic) and played. Such movies
  141.     will usually require an ARM3 (or better) to replay them.
  142.  
  143. If two suffixes are available, then the 2 should come first.
  144.  
  145. Calling programs should use the shortest name possible.
  146.  
  147. A note about compression numbers
  148. --------------------------------
  149.  
  150. The compression values allow for new video compressors to be written in the
  151. future. The Player program inspects the video value and, if it cannot process
  152. the format, calls <ARMovie$Dir>.DeComp<X>.!RunImage where <X> is the decimal
  153. string of the value of the compression type. Thus new compression types can
  154. be added transparently.
  155.  
  156. Compression types are allocated as follows:
  157.  
  158.    0-99: Acorn
  159.          video                             audio
  160.          0: no video                       0: no audio
  161.          1: 'Moving Lines' compression     1: uncompressed audio
  162.  
  163. 100-199: EIDOS
  164.  
  165. 200-299: Irlam instruments
  166.  
  167. 300-399: Wild Vision
  168.  
  169. Different compression types may have different sound compression (indeed, the
  170. entire meaning of the sound compression field is defined by the video
  171. compression type). However, if the sound compression is the same as one of the
  172. other sound compression methods, then the same number should be used - and,
  173. conversely, if a different sound compression method is being used, then a
  174. different number should be used. (Whew, what a nasty sentence). Thus companies
  175. should either use recognised sound compression numbers (and code...) or they
  176. should restrict their sound compression numbers to the same range as their
  177. video compression numbers.
  178.  
  179. A note about Stereo sound
  180. -------------------------
  181.  
  182. For a stereo sample, the left channel is the first sample, the right the
  183. second, etc. If this is not the case, include the word "reversed" in the
  184. number of channels field: "2 channels reversed".
  185.  
  186. WARNING: for type 0, audio type 1, Stereo 16 bits linear assumes that the
  187. start of each sound chunk is word aligned.
  188.  
  189. A note about ADPCM sound
  190. ------------------------
  191.  
  192. The software decompression of 4bit ADPCM requires large output buffers -
  193. 8 bit ones.
  194.